Leadtools.Jpeg2000 Requires Document/Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.12.10
SaveComposite(RasterCodecs,String,Generic List,Jpeg2000FileFormat,Int32,Int32) Method
See Also  Example
Leadtools.Jpeg2000 Namespace > Jpeg2000Engine Class > SaveComposite Method : SaveComposite(RasterCodecs,String,Generic List,Jpeg2000FileFormat,Int32,Int32) Method




codecs
The RasterCodecs object.
fileName
String containing the name of the file currently being saved.
compositeImages
List of CompositeJpxImages containing the image layer data that will be saved.
format
Output JPEG 2000 file format. For valid values, refer to Jpeg2000FileFormat.
bitsPerPixel
Resulting file’s pixel depth. Possible values are: 8, 12, 16, 24, 32, 48, 64, and 0. Zero [0] means that each image will be saved with its bits per pixel value, if that value is equal to one of the possible values (8, 12, 16, 24, 32, 48, or 64).
qualityFactor
Quality factor. This value determines the degree of loss in the compression process. Possible values are from 0 to 255. A value of zero (0) represents lossless compression. Values between 1 and 255 are interpreted as a compression ratio.
Saves a CompositeJpxImages list to a file in any of the supported JPEG 2000 file formats. This method is available in the Document/Medical Toolkits.

Syntax

Visual Basic (Declaration) 
Overloads Public Sub SaveComposite( _
   ByVal codecs As RasterCodecs, _
   ByVal fileName As String, _
   ByVal compositeImages As List(Of CompositeJpxImages), _
   ByVal format As Jpeg2000FileFormat, _
   ByVal bitsPerPixel As Integer, _
   ByVal qualityFactor As Integer _
)
Visual Basic (Usage)Copy Code
Dim instance As Jpeg2000Engine
Dim codecs As RasterCodecs
Dim fileName As String
Dim compositeImages As List(Of CompositeJpxImages)
Dim format As Jpeg2000FileFormat
Dim bitsPerPixel As Integer
Dim qualityFactor As Integer
 
instance.SaveComposite(codecs, fileName, compositeImages, format, bitsPerPixel, qualityFactor)
C# 
public void SaveComposite( 
   RasterCodecs codecs,
   string fileName,
   List<CompositeJpxImages> compositeImages,
   Jpeg2000FileFormat format,
   int bitsPerPixel,
   int qualityFactor
)
Managed Extensions for C++ 
public: void SaveComposite( 
   RasterCodecs codecs,
   string* fileName,
   List<CompositeJpxImages>* compositeImages,
   Jpeg2000FileFormat format,
   int bitsPerPixel,
   int qualityFactor
)
C++/CLI 
public:
void SaveComposite( 
   RasterCodecs codecs,
   String^ fileName,
   List<CompositeJpxImages>^ compositeImages,
   Jpeg2000FileFormat format,
   int bitsPerPixel,
   int qualityFactor
)

Parameters

codecs
The RasterCodecs object.
fileName
String containing the name of the file currently being saved.
compositeImages
List of CompositeJpxImages containing the image layer data that will be saved.
format
Output JPEG 2000 file format. For valid values, refer to Jpeg2000FileFormat.
bitsPerPixel
Resulting file’s pixel depth. Possible values are: 8, 12, 16, 24, 32, 48, 64, and 0. Zero [0] means that each image will be saved with its bits per pixel value, if that value is equal to one of the possible values (8, 12, 16, 24, 32, 48, or 64).
qualityFactor
Quality factor. This value determines the degree of loss in the compression process. Possible values are from 0 to 255. A value of zero (0) represents lossless compression. Values between 1 and 255 are interpreted as a compression ratio.

Example

Visual BasicCopy Code
Leadtools.Jpeg2000.Jpeg2000Engine.SaveComposite(String)
      Private Sub SaveCompositeStringExample(ByVal xmlData() As Byte)
         Dim codecs As New RasterCodecs()
         codecs.ThrowExceptionsOnInvalidImages = True

         ' Load a JPEG 2000 image
         Dim engine As New Jpeg2000Engine()
         Dim images As List(Of CompositeJpxImages) = engine.LoadComposite(codecs, "C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\image1.jpx", 0, CodecsLoadByteOrder.BgrOrGray)

         engine.ResetEngineBoxes()

         Dim gtsoBox As GtsoBox = DirectCast(engine.ReadBox("C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\image1.jpx", Jpeg2000BoxType.GtsoBox, 0), GtsoBox)
         engine.SetBox(Jpeg2000FileFormat.LeadJpx, gtsoBox)

         ' Save the image in JPX file format
         engine.SaveComposite(codecs, "C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Test.jpx", images, Jpeg2000FileFormat.LeadJpx, 24, 5)

         ' Append an XML box
         Dim _xmlBox As New XmlBox()
         _xmlBox.Data = xmlData
         Dim _xmlBoxes As New List(Of XmlBox)
         _xmlBoxes.Add(_xmlBox)
         engine.AppendBoxes("C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Test.jpx", _xmlBoxes)

         ' Clean up
         Dim _image As CompositeJpxImages
         For Each _image In images
            _image.ColorImage.Dispose()
            _image.OpacityImage.Dispose()
            _image.PreOpacityImage.Dispose()
         Next _image
         codecs.Dispose()
      End Sub
C#Copy Code
Leadtools.Jpeg2000.Jpeg2000Engine.SaveComposite(String) 
      private void SaveCompositeStringExample(byte [] xmlData) 
      { 
         RasterCodecs codecs = new RasterCodecs(); 
         codecs.ThrowExceptionsOnInvalidImages = true; 
 
         // Load a JPEG 2000 image 
         Jpeg2000Engine engine = new Jpeg2000Engine(); 
         List<CompositeJpxImages> images = engine.LoadComposite(codecs, @"C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\image1.jpx", 0, CodecsLoadByteOrder.BgrOrGray); 
 
         engine.ResetEngineBoxes(); 
 
         GtsoBox gtsoBox = (GtsoBox)(engine.ReadBox(@"C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\image1.jpx",Jpeg2000BoxType.GtsoBox, 0)); 
         engine.SetBox(Jpeg2000FileFormat.LeadJpx, gtsoBox); 
         //Save the image in JPX file format 
         engine.SaveComposite(codecs, @"C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Test.jpx", images, Jpeg2000FileFormat.LeadJpx, 24, 5); 
         //Append an XML box 
         XmlBox xmlBox = new XmlBox(); 
         xmlBox.Data = xmlData; 
         List<XmlBox> xmlBoxes = new List<XmlBox>(); 
         xmlBoxes.Add(xmlBox); 
         engine.AppendBoxes(@"C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Test.jpx", xmlBoxes); 
         // Clean up 
         foreach (CompositeJpxImages image in images) 
         { 
            image.ColorImage.Dispose(); 
            image.OpacityImage.Dispose(); 
            image.PreOpacityImage.Dispose(); 
         } 
         codecs.Dispose(); 
      }

Remarks

All of the engine boxes that are currently set will also be saved in this file.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Leadtools.Jpeg2000 requires a Document or Medical toolkit license and unlock key. For more information, refer to: Raster Pro/Document/Medical Features